Favicon

You are here: Home > API Reference > UEM > MDM Devices > Retrieve unified cross-platform device list

Retrieve unified cross-platform device list

Required Permission: mdm.global.device.list

Retrieves paginated list of all managed endpoints across Android Enterprise, AOSP non-GMS Android, iOS, macOS, and Windows with extensive filtering, compliance tracking, and policy assignment visibility for comprehensive fleet management.

GET
https://api.applivery.io/v1/organizations/{organizationId}/mdm/devices 
curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/mdm/devices" \
  -H "Authorization: Bearer <YOUR_API_KEY>"
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/devices", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();
import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/devices",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request header authorization
Example: Authorization: Bearer <token>

organizationId string
required
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

page integer
optional
Page number for pagination controls starting at one enabling navigation through large devices collections efficiently.
limit integer
optional
Maximum number of devices returned per page controlling result set size for pagination and performance optimization.
sort string
optional
Sort field and direction for ordering device list results enabling customized data presentation and filtering.
Match pattern: ^[\w.]*((:asc)|(:desc))?$
mdmUserId string
optional
Filter parameter for MDM user identifier to retrieve devices assigned to specific user.
Match pattern: ^[a-fA-F0-9]{24}$
type string
optional
Device platform type indicating Android Enterprise, AOSP non-GMS Android, Apple ecosystem, or Windows for platform-specific management operations.
androidapplewindowsaosp
subType string
optional
Device enrollment classification distinguishing fully enrolled devices from pending enrollment tokens for status tracking.
deviceenrollment
showAll boolean
optional
Filter flag to include deactivated or archived devices in results bypassing default active-only filter.
policyId string
optional
Filter parameter for policy identifier to retrieve devices with specific policy assignment.
Match pattern: ^[a-fA-F0-9]{24}$
imei string
optional
Filter parameter for device IMEI number enabling hardware-specific device lookups.
≤ 256 characters
serialNumber string
optional
Filter parameter for device serial number for manufacturer-specific device identification.
≤ 256 characters
state string
optional
Current device lifecycle state reflecting enrollment status, provisioning progress, or deactivation for management workflows.
≤ 256 characters
onlyAdmDep boolean
optional
Filter flag to retrieve only Apple DEP-enrolled devices for corporate-owned device reporting.
name string
optional
Filter parameter for device display name enabling partial name matching in search queries.
≤ 256 characters
isCompliance boolean
optional
Filter flag to retrieve only compliant or non-compliant devices for security auditing workflows.
lastSyncError boolean
optional
Filter flag to retrieve devices with recent synchronization errors for troubleshooting purposes.
emmEnrollmentTemplateId string
optional
Filter parameter for Android enrollment template identifier to group devices by enrollment method.
Match pattern: ^[a-fA-F0-9]{24}$
admEnrollmentTemplateId string
optional
Filter parameter for Apple enrollment template identifier to segment devices by enrollment workflow.
Match pattern: ^[a-fA-F0-9]{24}$
winEnrollmentTemplateId string
optional
Filter parameter for Windows enrollment template identifier for enrollment method-based device grouping.
Match pattern: ^[a-fA-F0-9]{24}$
tags array
optional
Array of organizational tags for grouping devices by department, location, or custom criteria in filtering workflows.
search string
optional
Full-text search parameter matching device names, serial numbers, IMEIs, or user emails for flexible discovery.
≤ 256 characters
osVersion string
optional
Filter parameter for operating system version enabling version-specific device targeting for updates.
≤ 128 characters
availableUpdate string
optional
Filter parameter for pending OS update version identifying devices eligible for upgrade campaigns.
≤ 128 characters
networkIp string
optional
Filter parameter for device network IP address enabling network-based device discovery and segmentation.
≤ 128 characters
segmentId integer
optional
Segment identifier for scoping devices into an specific segment
expandTo string
optional
Param to include ancestor or child related entities
ancestorschildren
sa array
optional
SmartAttributes array with id and value to filter devices by smart attributes

Responses

200 Response application/json
status boolean optional
data object optional
items array [object] optional
id string optional
Managed device unique identifier used for API operations, policy assignments, and tracking device lifecycle across platforms.
Match pattern: ^[a-fA-F0-9]{24}$
type string optional
Device platform type indicating Android Enterprise, AOSP non-GMS Android, Apple ecosystem, or Windows for platform-specific management operations.
android apple windows aosp
subType string optional
Device enrollment classification distinguishing fully enrolled devices from pending enrollment tokens for status tracking.
device enrollment
state string optional
Current device lifecycle state reflecting enrollment status, provisioning progress, or deactivation for management workflows.
≤ 128 characters
organization string optional
Organization identifier linking managed device to workspace for access control and resource isolation purposes.
Match pattern: ^[a-fA-F0-9]{24}$
organizationInfo object optional
Organization details object containing workspace name, slug, and branding information for dashboard display.
sortDate string optional
Timestamp used for chronological sorting in device lists, typically reflecting enrollment or last activity date.
Format: date-time
enrolledDate string optional
Device enrollment completion timestamp marking successful MDM profile installation or enrollment token acceptance.
Format: date-time
mdmUser object optional
Assigned MDM user object containing identifier and email for device ownership and communication tracking.
displayName string optional
Device custom display name set by administrator or user for easier identification in device listings.
≤ 128 characters
tags array [string] optional
Array of organizational tags for grouping devices by department, location, or custom criteria in filtering workflows.
emmEnterprise string optional
Android Enterprise (EMM) enterprise identifier linking device to Google workspace for managed play store access.
Match pattern: ^[a-fA-F0-9]{24}$
admEnterprise string optional
Apple Device Management enterprise identifier for DEP enrollment and VPP app assignment coordination.
Match pattern: ^[a-fA-F0-9]{24}$
aosEnterprise string optional
AOSP enterprise identifier linking non-GMS Android device or enrollment token to the organization custom DPC management tenant.
Match pattern: ^[a-fA-F0-9]{24}$
emmDevice string optional
Android Enterprise device identifier from Google API for direct device operations and policy synchronization.
Match pattern: ^[a-fA-F0-9]{24}$
lastStatusReportTime string optional
Timestamp of most recent device status report indicating last successful communication with MDM server.
Format: date-time
summary object optional
Hardware and software summary object aggregating device name, OS version, IMEI, battery status, and compliance state.
emmPolicy object optional
Currently assigned Android Enterprise policy defining device restrictions, app deployments, and security configuration.
admPolicy object optional
Currently assigned Apple Device Management policy controlling iOS macOS device settings and application deployment.
aosPolicy object optional
Currently assigned AOSP policy defining custom DPC device restrictions, applications, and security configuration for non-GMS Android devices.
appliedEmmPolicy object optional
Android policy version currently enforced on device, may differ from assigned policy during transition periods.
admPolicyAssignments array [object] optional
Prioritized list of Apple policies assigned to device for composition and conflict resolution strategies.
admPolicyAssignmentsEnforced array [object] optional
Apple policy assignments with automation rule attribution showing which rules triggered each assignment.
aosPolicyAssignments array [object] optional
Prioritized list of AOSP policies assigned to device or enrollment token for custom DPC policy composition.
lastLocation object optional
Most recent device geolocation coordinates captured during location tracking or lost mode activation.
admVppLocation string optional
Apple VPP location identifier for volume purchase program app assignments and license management.
Match pattern: ^[a-fA-F0-9]{24}$
lostMode object optional
Lost mode configuration object tracking activation status, timestamps, and last known location coordinates.
emmPolicyAssignments array [object] optional
Prioritized list of Android Enterprise policies assigned for device configuration composition.
emmPolicyAssignmentsEnforced array [object] optional
Android policy assignments with automation rule details documenting assignment triggers and device audience matching.
winPolicy object optional
Currently assigned Windows MDM policy controlling device restrictions and application deployments for Windows endpoints.
winPolicyAssignments array [object] optional
Prioritized list of Windows policies assigned to device for configuration composition workflows.
winPolicyAssignmentsEnforced array [object] optional
Windows policy assignments with automation rule attribution documenting assignment triggers.
networkIp string optional
Device current network IP address captured during last status report for network-based filtering.
≤ 128 characters
_base object optional
Platform-specific raw API response object from Android Enterprise, Apple MDM, or Windows Intune for advanced debugging.
deviceEmmPolicy object optional
Android Enterprise policy actually applied on device, may lag behind assigned policy during sync operations.
deviceAdmPolicy object optional
Apple Device Management policy actually installed on device, distinct from assigned policy during profile updates.
deviceWinPolicy object optional
Windows MDM policy actually enforced on device, may differ from assigned during synchronization delays.
createdAt string optional
Device record creation timestamp in database regardless of actual enrollment date.
Format: date-time
updatedAt string optional
Device record last modification timestamp reflecting any information changes in database.
Format: date-time
smartAttributes array [object] optional
smartAttributeAssignments array [object] optional
smartAttributeAssignmentsEnforced array [object] optional
segmentId integer optional
Segment identifier for scoping devices into an specific segment
≥ 0
devicePolicyStatus object optional
Device policy status object indicating whether the device policy device has been pushed to the device
totalDocs integer optional
≥ 0
{
    "status": true,
    "data": {
        "items": [
            {
                "id": "698f42e5457fafa13d088794",
                "type": "android",
                "subType": "device",
                "state": "ACTIVE",
                "organization": "698f42e5457fafa13d088795",
                "organizationInfo": {
                    "id": "698f42e5457fafa13d088795",
                    "name": "Acme Corp",
                    "slug": "acme"
                },
                "sortDate": "2024-03-15T14: 30: 00.000Z",
                "enrolledDate": "2024-03-15T14: 30: 00.000Z",
                "mdmUser": {
                    "id": "698f42e5457fafa13d088796",
                    "email": "[email protected]"
                },
                "displayName": "John Doe iPhone",
                "tags": [
                    "sales",
                    "remote",
                    "byod"
                ],
                "emmEnterprise": "698f42e5457fafa13d088797",
                "admEnterprise": "698f42e5457fafa13d088798",
                "aosEnterprise": "698f42e5457fafa13d0887b0",
                "emmDevice": "698f42e5457fafa13d088799",
                "lastStatusReportTime": "2024-03-20T10: 15: 00.000Z",
                "summary": {
                    "name": "string",
                    "osVersion": "string",
                    "managementMode": "DEVICE_OWNER",
                    "imei": "string",
                    "battery": "string",
                    "expirationTimestamp": "2024-01-01T00: 00:00Z",
                    "os": "string",
                    "serialNumber": "string",
                    "supervised": true,
                    "compliance": {},
                    "image": "string",
                    "manufacturer": "string",
                    "model": "string",
                    "udid": "string",
                    "hostname": "string",
                    "ipAddress": "string",
                    "macAddress": "string"
                },
                "emmPolicy": {
                    "id": "698f42e5457fafa13d08879a",
                    "name": "Corporate Android Security",
                    "version": "3"
                },
                "admPolicy": {
                    "id": "698f42e5457fafa13d08879b",
                    "name": "Corporate iOS Security",
                    "version": "2"
                },
                "aosPolicy": {
                    "id": "698f42e5457fafa13d0887b1",
                    "name": "Corporate AOSP Security",
                    "version": "7"
                },
                "appliedEmmPolicy": {
                    "id": "698f42e5457fafa13d08879a",
                    "name": "Corporate Android Security",
                    "version": "3"
                },
                "admPolicyAssignments": [
                    {
                        "admPolicyId": "698f42e5457fafa13d08879c",
                        "admPolicy": {},
                        "priority": 1
                    }
                ],
                "admPolicyAssignmentsEnforced": [
                    {
                        "admPolicyId": "698f42e5457fafa13d08879c",
                        "admPolicy": {},
                        "priority": 1,
                        "automationRule": {
                            "id": "698f42e5457fafa13d08879d",
                            "name": "Sales Team iOS Policies",
                            "deviceAudiences": [
                                {
                                    "id": "698f42e5457fafa13d0887a7",
                                    "name": "Sales Department",
                                    "reasons": [
                                        "tag:sales",
                                        "user.department:Sales"
                                    ]
                                }
                            ]
                        }
                    }
                ],
                "aosPolicyAssignments": [
                    {
                        "aosPolicyId": "698f42e5457fafa13d0887b1",
                        "aosPolicy": {
                            "id": "698f42e5457fafa13d0887b1",
                            "name": "Corporate AOSP Security",
                            "version": "7"
                        },
                        "priority": 100
                    }
                ],
                "lastLocation": {
                    "agent": {
                        "origin": "agent",
                        "date": "2024-01-01T00: 00:00Z",
                        "latitude": 0,
                        "longitude": 0,
                        "ip": "string",
                        "lastReportDate": "2024-01-01T00: 00:00Z",
                        "address": {
                            "address": "string",
                            "number": "string",
                            "postalCode": "string",
                            "city": "string",
                            "country": "string"
                        }
                    },
                    "ip": {
                        "origin": "agent",
                        "date": "2024-01-01T00: 00:00Z",
                        "latitude": 0,
                        "longitude": 0,
                        "ip": "string",
                        "lastReportDate": "2024-01-01T00: 00:00Z",
                        "address": {
                            "address": "string",
                            "number": "string",
                            "postalCode": "string",
                            "city": "string",
                            "country": "string"
                        }
                    }
                },
                "admVppLocation": "698f42e5457fafa13d0887a0",
                "lostMode": {
                    "enabled": true,
                    "startDate": "2024-03-25T09: 00: 00.000Z",
                    "endDate": "2024-03-26T15: 30: 00.000Z",
                    "stoppedBy": "admin",
                    "lastLocation": {
                        "latitude": 407128,
                        "longitude": 74006,
                        "batteryLevel": 45
                    }
                },
                "emmPolicyAssignments": [
                    {
                        "emmPolicyId": "698f42e5457fafa13d08879f",
                        "emmPolicy": {},
                        "priority": 1
                    }
                ],
                "emmPolicyAssignmentsEnforced": [
                    {
                        "emmPolicyId": "698f42e5457fafa13d08879f",
                        "emmPolicy": {},
                        "priority": 1,
                        "automationRule": {
                            "id": "698f42e5457fafa13d0887a1",
                            "name": "Android Corporate Policy",
                            "deviceAudiences": []
                        }
                    }
                ],
                "winPolicy": {
                    "id": "698f42e5457fafa13d0887a2",
                    "name": "Corporate Windows Security",
                    "version": "1"
                },
                "winPolicyAssignments": [
                    {
                        "winPolicyId": "698f42e5457fafa13d0887a3",
                        "winPolicy": {},
                        "priority": 1
                    }
                ],
                "winPolicyAssignmentsEnforced": [
                    {
                        "winPolicyId": "698f42e5457fafa13d0887a3",
                        "winPolicy": {},
                        "priority": 1,
                        "automationRule": {
                            "id": "698f42e5457fafa13d0887a4",
                            "name": "Windows Corporate Policy",
                            "deviceAudiences": []
                        }
                    }
                ],
                "networkIp": "10.0.1.25",
                "_base": {},
                "deviceEmmPolicy": {
                    "id": "698f42e5457fafa13d08879a",
                    "name": "Corporate Android Security",
                    "version": "3"
                },
                "deviceAdmPolicy": {
                    "id": "698f42e5457fafa13d08879b",
                    "name": "Corporate iOS Security",
                    "version": "2"
                },
                "deviceWinPolicy": {
                    "id": "698f42e5457fafa13d0887a2",
                    "name": "Corporate Windows Security",
                    "version": "1"
                },
                "createdAt": "2024-03-15T14: 30: 00.000Z",
                "updatedAt": "2024-03-20T16: 45: 00.000Z",
                "smartAttributes": [
                    {
                        "id": "string",
                        "type": "constant",
                        "label": "string",
                        "value": "string",
                        "updatedAt": "2024-01-01T00: 00:00Z"
                    }
                ],
                "smartAttributeAssignments": [
                    {
                        "smartAttributeId": "string",
                        "smartAttribute": {
                            "id": "string",
                            "segmentId": 0,
                            "name": "string",
                            "description": "string",
                            "output": {
                                "type": "string"
                            },
                            "input": {
                                "type": "constant",
                                "source": "it"
                            }
                        }
                    }
                ],
                "smartAttributeAssignmentsEnforced": [
                    {
                        "smartAttributeId": "string",
                        "smartAttribute": {
                            "id": "string",
                            "segmentId": 0,
                            "name": "string",
                            "description": "string",
                            "output": {
                                "type": "string"
                            },
                            "input": {
                                "type": "constant",
                                "source": "it"
                            }
                        },
                        "mdmAutomationRule": {
                            "id": "string",
                            "deviceAudiences": [
                                {
                                    "id": "string",
                                    "reasons": [
                                        "string"
                                    ]
                                }
                            ]
                        }
                    }
                ],
                "segmentId": "1",
                "devicePolicyStatus": {
                    "pushed": true,
                    "audit": {
                        "name": "policyName",
                        "config": {
                            "version": "1"
                        },
                        "device": {
                            "version": "1"
                        }
                    }
                }
            }
        ],
        "totalDocs": 0
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4001
message string optional
Unauthorized
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}